为轴组及所有在该轴组上使用的方法设定一个覆盖值。此覆盖参数可作为一个用来计算运动速度、加速度和加加速度指令的因子。
命名空间：IntervalZero.KINGSTAR.Local.Api
组合： IntervalZero.KINGSTAR.Local.Api (于 IntervalZero.KINGSTAR.Local.dll) 版本：4.4.0.0
语法
public KsError SetGroupMotionProfileOverride(
int Index,
double VelocityFactor,
double AccelerationFactor,
double JerkFactor
)Public Function SetGroupMotionProfileOverride(
Index As Integer,
VelocityFactor As Double,
AccelerationFactor As Double,
JerkFactor As Double
) As KsError参数
Index [in]
型别：int
轴组的索引。索引以 0 为起始。最多可有 32 个轴组。
VelocityFactor [in]
型别：double
速度的新覆盖因子。
AccelerationFactor [in]
型别：double
加速度或减速度的新覆盖因子。
JerkFactor [in]
型别：double
加加速度的新覆盖因子。
回传值
型别：KsError
方法的回传代码。
备注
- 此方法在不改变初始值的情况下改变速度、加速度与加加速度，并在发送此方法后立即生效。当轴组在运动状态下使用此方法，则目前的运动将会改变，为避免非预期的结果，建议在停止 (Standstill) 状态下使用此函式。
- 输入 AccelerationFactor 作用于正负加速度（减速度）。
- 此方法可用来设定因子，覆盖因子直到有新的覆盖因子设定前皆有效。
- 覆盖因子的预设值为 1.0。
- 覆盖值可介于 0.0 至 1.0 之间，值 > 1.0 为供应商特定的值、值不可 < 0.0，而值 0.0 不允许设定在 AccelerationFactor 与 JerkFactor。
- 将 VelocityFactor 的值设定为 0.0 能使轴组在不进入静止 (Standstill) 状态下即停止。
- 覆盖无法在从轴上执行（处于同步运动状态的轴）。
- 此方法不影响轴组的状态图。
- VelocityFactor 可随时更改并直接作用于进行中的运动。
- 在 "离散运动" 中减少 AccelerationFactor 和／或 JerkFactor 恐导致位置过冲－造成损坏。
范例
N/A参见